SWTPC 6800 DISASSEMBLER 


BY MICHAEL J. DENNIS 


The DESEMBLER program can be used to "de-assemble" a loaded 
machine code program. This may be desirable to aid debugging or 
to assist in understanding, correcting or modifying a machine code 
supplied program. The DESEMBLER lists the memory address of each 
byte of the instruction, the equivalent ASCII character of each byte, 
the assembly language mnumonic of the machine code instruction 
along with addressing symbols and the operand. Some of the features 
of this program are: 

The DESEMBLER can be run from any location in memory. 

Program has a built in "move" routine which will move the 
DESEMBLER to the desired memory location. 

Program has a "byte search" option which will find every 
occurance of a specified byte within a memory area and 
print it out with its address, the preceeding byte, and 
the following two bytes. 

The DESEMBLER has an optional "intersection mark" feature 
which marks in the desembled listing the program locations 
to which the program branches or jumps to. These marks 
indicate whether it was a direct branch or a subrountine 
type branch. This option will also cause a symbols table 
listing of the intersection addresses to be printed after 
the regular desembler listing. 

Output may be directed to any port via a control, asynchronous 
(ACIA), or parallel (PIA) interface. 

No memory locations need be initialized prior to running the 
DESEMBLER other than the program counter (A048-A049). 

Hardware configuration and software support : 

This program is designed to run in any 2.5K of continous 
memory on a SWTPC 6800 computer system. Program requires MIKBUG* 
software and much of the MIKBUG* RAM memory (A000-A07F). The 
DESEMBLER communicates with the control terminal at port #1 and 
asynchrounos serial output devices such as a TELETYPE* or parallel 
output devices such as a PR-40 printer are supported as options at 
any other port. The DESEMBLER as supplied initially loads into 
memory locations 0100-0AFF. 


*MIKBUG is a registered trademark of Motorola Inc. 
*TELETYPE is a registered trademark of Teletype Inc. 
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Operation of the DESEMBLER ; 

Upon loading A048 and A049 with the starting address (0100) and 
typing the MIKBUG* command "G" to start, the DESEMBLER will identify 
itself on the control terminal and ask for the option wanted as shown. 

SWTPC DESEMBLER V.4 

OPTION (D,S,M,E): 

The user should then type a D, S, M, or E where: 

D indicates a desembled listing is desired, (disassembly) 

S for byte search routine. 

M for moving DESEMBLER program to new memory location. 

E for exiting back to MIKBUG*. 

If "E" is entered, the program immediately returns to MIKBUG*. 

To restart DESEMBLER type MIKBUG* command "G". 

If "M" is typed the program will ask: 

NEW BEGINNING ADDRESS: 

The user should key in the desired 4 digit hex address that the program 
should be moved to. The program will restart upon completion at the 
new location. When a move is made, be sure that sufficient memory 
exists for the program and for the creation of the intersection data 
file (symbol table) if intersection marks are to be printed. Inter¬ 
sections point to places in the program to where a branch or jump 
instruction terminates. 

If the "D" option is chosen, the DESEMBLER will ask: 

MARK INTERSECTIONS? (Y/N) 

If the user wants the program to indicate the address locations which 
the desembled program branches or jumps to, he should type a "Y" for 
yes, otherwise "N" should be typed for no. In the listing, locations 
that are referred to by a BSR or JSR instruction will be flagged by 
a>. Locations referred to by a branch instruction are flagged by a -. 

The DESEMBLER will then ask: 

INPUT FILE ADDRESS: 

The user should key in the 4 digit hex beginning address of the area 
of memory to be desembled. The program will then type "TO" and the 
user should key in the ending address of this memory area. The DESEMBLER 

will than ask: 

PORT & DEVICE (0-7; C,S,P): 

The user should respond with the port number and the output device 
type where "C" is the control interface, "S" is a serial (ACIA) interfaced 
device, and "P" indicates a parallel interfaced printer. Note that if 
"C" is chosen, output will be to port #1 regardless of the entered port 
number. 

The DESEMBLER will then type: 

HEADER: 

The user should respond with the title to be printed on the desembled 
listing, up to 44 characters in length, terminated by a carriage return. 

If "S" was the option chosen, indicating a "byte search", the 
program will ask for the input file address and the port and device as 
it would for the "D" option. The program will then ask for the "BYTE 
DESIRED:". The user should enter the 2 digit hex number. The DESEMBLER 
will then output to the selected output device the address of each 
occurance, the preceeding byte, the byte of interest (corresponding to 
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the address), and the following two bytes. To exit from this routine a 
reset of carriage return must be hit. To restart program type the 
MIKBUG* command "G". 

Input notes ; 

If an illegal option or output device is entered, the DESEMBLER 
will re-ask the question. If an error occurs in the input of a number, 
however, program control returns to MIKBUG*. The command "G" will 
restart the DESEMBLER. If too many characters are entered in the header 
title, the carriage return will be assumed as the 44th character and 
output will begin. 

Output notes : 

The "desemble" option of the DESEMBLER will produce a pagenated 
output including cut marks, the header title, and the page number. The 
page will list 56 (38 hex) lines which include the memory address of the 
instruction, the memory contents and ASCII equivalent of each byte in 
the instruction, the instruction mneumonic, addressing symbols and 
operand. The addressing symbols and operand are in the following format: 
blank for inherent addressing 

it 3E or it A03E for immediate addressing 

A03E or 003E for extended or direct addressing 

X, 3E for indexed addressing 

023E for relative addressing 

Note that all numbers are hexadecimal. Also note that relative addressing 
gives the absolute address of the branch rather than the relative address 
contained in the next memory location. 

Next to the memory contents in the DESEMBLER output is printed the 
ASCII equivalent of the byte or a space. A space is printed for all 
control characters or non-capital ASCII characters. Whether or not the 
equivalent ASCII character is printed out for other values depends on 
the parity of the memory contents (the most significant bit) and on the 
instruction at the relative address of 0286 (hex) in the DESEMBLER program. 
If the starting address of the DESEMBLER + 286 (hex) contains 

20 then no ASCII characters will be printed, 

2B then ASCII characters with parity=0 will be printed (default), 

2A then ASCII characters with pari-y=l will be printed, 

25 then all ASCII characters will be printed regardless of parity. 

The number of lines printed per page is controlled by the number in the 

relative address 246 of the DESEMBLER program (normally 38 hex). 

(0286 relative is location 0386 and 0246 relative is 0346 if the 
DESEMBLER is origined at 0100 as supplied. When a move is done the 
locations will naturally change.) 

Below is a sample run of the DESEMBLER with some comments on the output. 


NOTE Location 0A14 in the object dump should be 42 and location 0A15 
should be C9. 
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*G SWTP 6800 DESEMBLER V.4 

OPTION (D,S,M,E): D 

MARK INTERSECTIONS? (Y/N) Y 

INPUT FILE ADDRESS: 0100 TO 0175 
PORT & DEVICE (0-7; C,S,P): 7P 

HEADER: DESEMBLER VER. 4.0 


DESEMBLER VER 

4 0 

F’AGE 0 

' 1 



0100 

34 


4 

DES 




0101 

34 


4 

DES 




0102 

20 

6E 


ERA 


.. • 

01 or 

0104 

FE 

A048 

H 

- LDX 



AO 4 8 

0107 

FF 

AO 1 4 


STX 



AO 14 

01OA 

86 

71 


LDA 

A 

# 

71 

01OC 

08 



- I NX 




010D 

4A 


•J 

DEC 

A 



010E 

26 

FC 

&. 

BNE 


. 

01 OC 

01 10 

FF 

AO 16 


STX 



AO 16 

01 1 3 

CE 

A054 

T 

LDX 


# 

A054 

01 16 

FF 

A04E 

N 

- STX 



A04E 

01 1 

FE 

AO 16 


LDX 



AO 16 

011C 

A 6 

00 


LDA 

A 

x. 

00 

01 1E 

08 



I NX 




01 IF 

FF 

AO 16 


STX 



AO 16 

0122 

FE 

A04E 

N 

LDX 



A04E 

0125 

A7 

00 


STA 

A 

X 

00 

0127 

os 



I NX 




0128 

31 

3B 


CMF 

A 

# 

SB 

012A 

26 

EA 


BNE 


*•. 

01 1 o 

012C 

06 

06 


LDA 

A 

# 

06 

012E 

8 Cl 

67 


ESR 



0 i 97 

0130 

ED 

E047 

G 

JSR 



E047 

0133 

FF 

AO 4 A 

■J 

STX 



AO 4 A 

0136 

FF 

A04C 

u 

STX 



A04C 

0 1 39 

FF 

A048 

h 

STX 



AO 4 8 

013C 

5F 


+r 

CLB 

E 



013D 

B6 

A04A 

J 

LDA 

A 


AO 4 A 

0140 

El 

AO 14 


CMF 

A 


AO 14 

0143 

2E 

OA 

4- 

EMI 


■ 

0 i 4F 

0145 

2E 

13 


BGT 



015A 

0147 

B6 

A04E 

K 

LDA 

A 


A04E 

014A 

El 

AO 15 


CMF 

A 


AO 15 

014D 

2A 

OB 

* 

ERL 



01 5A 

014F 

5C 


\ 

- INC 

E 



0150 

86 

OA 


LDA 

A 

# 

OA 

0152 

BE 

A04C 

L 

ADD 

A 


A04C 

0155 

E7 

A04C 

L 

STA 

A 


AO 40 

0158 

20 

10 


ERA 


*•. 

016 A 
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S15.301003434206B F E A048F F A 0148671084A26FCF4 
81130110FFA016CEA054FFA04EFEAO16A60008FF16 
81130120A016FEA04EA70008813B26EA3606SD672E 
8i130130EDE047FFA04AFFA04CFFA0485FB6A04A1D 
81i30140B1 AO 142B0A2E13B6A04BB1AO 152A0B5C38 
81130150860ABBA04CB7A04C2010860ABBA014B7DB 
81i30160A014860ABEA04AB7A04A7EA054209520EA 
8113017032FEA014A6008D14FFA014FEA04AA7000E 
81130180BCA04C270E8005FFA04A20E55026020980 
811301903908398EA0423B206020D20S0808084ASA 
811301 AO2 6F939FEA04 886E 4 8DF1FFAO18860DSD4E 
811301BOEAFFAO1A86178DE3FFA01C86298DDCFFB9 
811301COAO1E860D8DD3FFA0208641SOCEFFA022D6 
8113010086013DC78DC5FFA024CE8004FFA028868C 
811301EOO1B7A02A86028D11BDE1ACB7A052814DA2 
811301F027A7814526487EE0D02041860A8D3DFE12 
81130200A020860C0S4A26FCBDE07EBDE0S516FE03 
8113021OAG140908A600112619FFA04ACEA04A86F8 
81130220F08D19FEA04A098D108D0E860ASDCDFEE3 
81130230A04ABCA01626DC20C28D004F2061814458 
81130240270681532693201086078D53BDE1AC5FAA 
81130250815926015CF7A02C86038D43BDE047FF3E 
81130260A01486048D39BDE047FFA01686058D2FA6 
81130270BDE0AA81082AF5484816BDE1 ACS 14327B0 
811302802E81532710815026E38D0D86FFB7A02AAB 
81130290A700863F A7012017F7A029FEA028392030 
311302A0438DF54FB7A02AS613A7008611A700B681 
811302B0A052815327817FA050FEA020BDE07ECEB6 
811302C0A054BDE1 ACS 10D2708A700083CA07F26AF 
811302D0F18604A700FEA01CADOOFEAO14FFA04AF6 
811302E08D4620132065F6A0315C2004860A8DSB9B 
811302F05A26F98D33FEAO1A6E008D083D4F8D7924 
811303008D1720F67AA05126028D1DFEA04A8D007D 
811303108D0009BCAO1627CE39B6A02DFEA04A4AEE 
8113032027F608FFA04A20F78608801FCEA0548D1B 
8113033069860B8D1686008012CEA050A6008B01FA 
8113034019A7008D5E8638A700S6092043860A8D8A 
811303503FCEA04A36F03038FEA01EAD00F6A02D3B 
81130360F EA04A8D168047801280108D3FF6A02D5F 
81130370FEA04A800BS009200720265A2B2E202300 
811303805A2B2BA6000S2E26484828224644202016 
S11303904D2B6C276C206E3D1708A600810426F760 
811303A039207AA600S048A6000820478D00S620B3 
811303B0FFA04C847FFEA0287DA02A2B172707BD11 
811303C0E101F E AO 4 C3937E600575724F A A7013390 
81130300FEA04C3937A700C637E701C63FE7016009 
811303E0012AFCE60033FEA04C39A6000S20C14403 
811303F0444 4 4 4840F 8 El30813923B58B0720B18050 
81130400A280A08614FFA04EFEA02037E60008C1 EE 
811304100426F94A26F6808233FEA04E39860B3DCA 
81130420E4FEA01SAD00S614SDDBFEA02FC6068059 
81130430B98DB78DB58DCC80B180C8B6A02E2601E2 
81130440394A2609860C8DE0FEA04A20E24A2609E7 
81130450860E80B1FEA04A20A84A2622860F80A5B0 
81130460FEA04AA60008FFA052CEA052402A026A5E 
81130470005FAB01E900E700A701208320874A263E 
8113048004861020CD8611F6A0205A5A27C420B612 
81130490FEA04AFFA03108FFA04A70A02C26013'906 
811304A08054BCA0262604860C20D18614C680E474 


811304B0)0027024A 4 A 8 0 F28614C640E40027014ftt<6 
811304C020E720B67DA02C2753FEAG1409FFA04AE4 
811304DGFEA04A08FFA04ABCAO1626037EE000FF77 
811304E0A0318012BCA02627E78DC0CEA04 A8002A4 
811304F0860A80B5200AB6A031843FB7A031FEAOBC 
811305002409090808BCA026260139A600843FB1A5 
81130510A03126EFA601B1A03226E8397EE0000052 
8113052070A02C260139FEA024FFA0266F006F01B8 
81130530FEA014FFA04AA600817E272981BD272C96 
81 1305408180273784F0812027388078FEA04AB624 
81130550A02D08BCA016270S4A26F7FFA04A20D6DB 
811305603920E 720918680E7A02B20058640B7A0CC 
811305702B F E A 0 4 AE E 01FFAO3120248640B7A02B19 
8113058020058680B7A02B08A60008FFA031CEA0C6 
8113059031402A026A005FAE01E900E700A7018033 
811305A0C2BCA026260B6F020S6F0208FFA0260912 
811305B009B6A031BAA02BAA00A700B6A032A701A1 
811305C0209F0000FEA04AE600FEA0225C08080S66 
81130500085A26F9FFA02F801380111727044444C0 
811305E0444C4CE7A02DC407F7A02E398D00A600AB 
811305F04S59083900000000000A0A484541444590 
8113 0 6 0 0523A 2 0 04 0 0 0 A4 2 595445204445534 9 5254 
8113061045443A2004101653575450203638303080 
81130620204445534540424C45S22020562E340D0E 
811306300A0A0A4F5054494F4E2028442C532C4D3E 
811306402C45293A2004000A0A494E505554204697 
81130650494C4520414444524553533A20042054C4 
811306604F2004000A504F52542026204445564929 
81130670434520283020373B20432C532C50293A16 
811306802004000A4E455720424547494E4E494E07 
811306904720414444524553533A2004000A4041E6 
811306A0524B20494E54455253454354494F4E539F 
811306B03F2028592F4E2920040D0A0A0A0A2D2DF0 
811306C02D2D0D0A0A0A0A04000A0A04000A000453 
8113060020202020202020200420200450414745B1 
811306E02004582C2020043E2004202030300423F1 
811306F0200420043E04200400000000000000003B 
811307003F2020204E4F50203F2020203F202020FB 
811307103F2020203F202020544150205450412080 
81130720494E582044455820434C562053455620A2 
81130730434C432053454320434C492053454920CF 
8113074053424120434241203F2020203F2020208B 
811 3 07503: F2020203F20202054 4142205442412069 
811307603F202020444141203F2020204142412070 
811307703F2020203F2020203F2020203F202020F9 
811307804252C1A03F2020204248C9A0424CD3A0D0 
811307904243C3A04243D3A0424EC5A0424501A088 
811307A04256C3A04256D3A04250CCA0424DC9A049 
811307B04247C5A0424CD4A0424704A0424CC5A055 
811307C054535820494E532050554C4150554C4297 
8113070044455320545853205053484150534842A1 
811307E03F202020525453203F202020525449209F 
311307F03F2020203F20202057414920535 74920A3 
811308004E4547413F2020203F202020434F40416B 
811308104C5352413F202020524F524141535241 AS 
8113082041534C41524F4C41444543413F202020C9 
81130830494E4341545354413F202020434C52419C 
811308404E4547423F2020203F202020434F404229 
811308504C5352423F202020524F52424153524265 
8113086041534C42524F4C42444543423F20202086 




S1130870494E4342545354423F202020434C524259 
S11308S 0 4 E 4 5 C7203F2020203F202020434F C D202D 
S1130S904C53D2203F202020524FD2204153D2200B 
SI 1308A04153CC20524FCC2044 45C3203F2020202C 
S11308B0494E C3205453D4204A 4 D D020434C D22017 
811308C0CE4547A03F2020203F202020C34F4DA0ED 
S11308D0CC5352A03F202020D24F52A0C15352A04B 
811308E0C1534CA0D24F4CA0C44543A03F2020206C 
811308F 0 C 9 4 E 4 3 AO D45354A 0 C A 4 D 5 0 A 0 C 3 4 C 5 2 A 0 D 7 
8113090C|53 D542C l|43CD30C l|53C243C l|3F20202CtoF 
8113091041CE44C142C954C14CC441C13F202020EE 
8113092045CF52C141C443C14FD241C141C444C166 
81130930C3D058A04253D2A0CCC453A03F202020FF 
8113094053D5424143CD504153C243413F2020201F 
8113095041CE444142C954414CC4414153D4414124 
8113096043&CF524141C443414FD2414141C4444126 
8113097043D058203F2020204CC4532053D453202C 
811309805355C241434DD0415342C3413F202020DF 
81130990414EC441424904414C44C1415354C141E4 
811309A0454FD2414144C3414F52C1414144C441E6 
811309B04350D8204A53D2204C44D3205354D320FC 
811309C0D35542C1C34D50C1D34243C13F2020201F 
811309DOC14E44C1C24954C1CC4441C1D35441C1A4 
811309E0C54F52C1C14443C1CF5241C1C14444C1A6 
8113O9FOC35O58A0CA5352AOCC4453AOD35453AOBC 
81130A0053D5420643CD50C253C243C23F202020DB 
81130A1041 CE44dSt€24254C24CC441C23F202020F1 
81130A2045CF52QJ241C443C24FD241C241C444C261 
S1130A303F2020203F202020CCC458A03F2020204D 
81130A4053D5424243CD504253C243423F2020201B 
81130A5041CE444242C954424CC4414253D441421F 
81130A6045CF524241C443424FD2414241C4444221 
81130A703F2020203F2020204CC4582053D458200D 
81130A805355C242434DD0425342C3423F202020DB 
81130A90414EC4424249D4424C44C1425354C142DF 
81130AA0454FD2424144C3424F52C1424144C442E1 
81130AB03F2020203F2020204C44D8205354D820CD 
S11 3 0 AC 0 D35542C 2 C 3 4 D 5 O C 2 D34243C 2 3 F2020201B 
81130AD0C14E4 4C2C24954C2CC4441C2D35441C29F 
81130AE0C54f52C2C14443C2CF5241C2C14444C2A1 
8113 0 AF 0 3FZ 020203F202020C C4458A 0 D35458A 0 8 D 






NOTICE TO USERS OF SWTPC PAPER AND CASSETTE TAPES 


In order to help reduce the time necessary to load programs through either a paper tape reader or an 
SWTPC AC-30 cassette interface, the longer tapes supplied from SWTPC will be furnished in a binary for¬ 
mat instead of the conventional ASCII. At the beginning of each tape is a binary loader program that will 
load into the computer using the regular ASCII format. The program then executes itself and loads the 
main program in binary. Using this method, tapes will load in approximately 1/3 normal time. When using 
an SWTPC AC-30, lock the reader in the ON position and type L. For paper tapes readers, such as on an 
ASR-33 Teletype,®when the load stops after the binary loader has been loaded into the computer simply 
type G. This will execute the binary loader and the remainder of the tape will load into memory. Several 
"garbage" characters may be printed immediately after the binary loader loads in—this is normal. On cas¬ 
sette tapes, one side will be in conventional ASCII (side with long leader) and one side will be in binary. 
The tapes are formatted as follows: 


L 

BINARY LOADER 

IN ASCII 

S9 

G 

MAIN PROGRAM 

IN BINARY 


As the tape loads, you will see one of the following displays on your terminal: (either is OK) 

*L *L 

*G *?? 

* (register dump) * (register dump) 

Some tapes may have an additional feature which will verify that the tape loaded correctly into 
memory. If, after loading the tape, you find that the program counter is not automatically set to the cor¬ 
rect value then you probably have a verifying tape. If this is the case simply typing a G will automatically 
check the validity of the program and execute it. If the message LOAD ERROR is displayed then the tape 
did not load correctly into memory. The most common cause of this is a memory problem—there can be 
problems that MEMCON and ROBIT will not find. 


The format for a self-verifying tape is as follows: 


VERIFICATION 

ROUTINE 

BINARY LOADER 
PGM. CTR. 

BINARY LOADER 
IN ASCII 

S9 

G 

MAIN PROGRAM 
IN BINARY 

MAIN PROGRAM 
PGM. CTR. 


ASCII- 11 -BINARY 


As before, one side of a cassette tape will be in binary and the other side in ASCI I. 
If you are unable to load a tape please check the following: 

1. ) Be sure the reader is locked on to load a binary cassette tape. 

2. ) Try different volume and tone control settings. 

3. ) Clean your tape heads with alcohol and a cotton swab. 

4. ) Re-check all memory if a LOAD ERROR is displayed. 


Teletype 


is a registered trademark of Teletype Corp. 



























